package com.zzgc.common.dao;

import com.zzgc.common.entity.StudentArchives;
import com.zzgc.modules.param.StudentArchivesParam;
import org.apache.ibatis.annotations.Param;
import org.springframework.data.domain.Pageable;
import java.util.List;

/**
 * 学生档案模板(StudentArchives)表数据库访问层
 *
 * @author makejava
 * @since 2023-01-31 11:17:56
 */
public interface StudentArchivesDao {

    /**
     * 通过ID查询单条数据
     *
     * @param id 主键
     * @return 实例对象
     */
    StudentArchives queryById(Long id, String tableName);

    /**
     * 查询指定行数据
     *
     * @param studentArchives 查询条件
     * @param pageable         分页对象
     * @return 对象列表
     */
    List<StudentArchives> queryAllByLimit(StudentArchives studentArchives);
    /**
     * 统计总行数
     *
     * @param studentArchives 查询条件
     * @return 总行数
     */
    long count(StudentArchives studentArchives);
    /**
     *  查询数据, 查询筛查档案
     *
     * @param archivesParam 查询条件
     * @return 对象列表
     */
    List<StudentArchivesParam> queryAllByLimitArchives(StudentArchivesParam archivesParam);
    /**
     *  查询数据, 查询筛查档案, 可以根据县区查询
     *
     * @param archivesParam 查询条件
     * @return 对象列表
     */
    List<StudentArchivesParam> queryAllByArchives(StudentArchivesParam archivesParam);

    /**
     * 统计总行数
     *
     * @param archivesParam 查询条件
     * @return 总行数
     */
    long queryAllByLimitArchivesCount(StudentArchivesParam archivesParam);


    /**
     * 统计总行数
     *
     * @param archivesParam 查询条件
     * @return 总行数
     */
    long queryAllByArchivesCount(StudentArchivesParam archivesParam);
    /**
     * 新增数据
     *
     * @param studentArchives 实例对象
     * @return 影响行数
     */
    int insert(StudentArchives studentArchives);

    /**
     * 批量新增数据（MyBatis原生foreach方法）
     *
     * @param entities List<StudentArchives> 实例对象列表
     * @return 影响行数
     */
    int insertBatch(@Param("entities") List<StudentArchives> entities);

    /**
     * 批量新增或按主键更新数据（MyBatis原生foreach方法）
     *
     * @param entities List<StudentArchives> 实例对象列表
     * @return 影响行数
     * @throws org.springframework.jdbc.BadSqlGrammarException 入参是空List的时候会抛SQL语句错误的异常，请自行校验入参
     */
    int insertOrUpdateBatch(@Param("entities") List<StudentArchives> entities);

    /**
     * 修改数据
     *
     * @param studentArchives 实例对象
     * @return 影响行数
     */
    int update(StudentArchives studentArchives);

    /**
     * 通过主键删除数据
     *
     * @param id 主键
     * @return 影响行数
     */
    int deleteById(Long id);

    /**
     * 通过省级ID， 学年， 筛查次数，查询单条数据
     *
     * @param uniqueId 主键
     * @param year 主键
     * @param number 主键
     * @return 实例对象
     */
    StudentArchives queryByUniqueIdYearNumber(@Param("uniqueId") Long uniqueId, @Param("year") String year, @Param("number") Integer number, @Param("tableName")String tableName);
}

